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Abstract 

When PRIMOS crashes or is manually halted, it is the responsibility of the PRIMOS 
engineering staff to determine the cause of the problem. So much information is kept by 
PRIMOS on a crash dump tape that the cause of almost any crash may be determined. On 
the other hand, this information may be overwhelming in its magnitude, and found by only 
the most knowledgeable PRIMOS wizards. In order to help mere mortals anal3rze PRIMOS 
crash dumps, a program called AUTOPSY exists. This document describes that program. 

PE-T-484. Rev.l describes AUTOPSY as of version 19.0.14. 

This document is a complete rewrite of the original PE-T-484, and therefore change bars 
have not been used. 
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1 Introduction 

In order to analyze a PRIMOS crash dump to determine the cause of the crash, a tremendous 
volume of data may have to be examined. Only a very few people at PRIME know where 
most of this data lives, and it is a reasonably safe bet that no one person knows where 
everything is. Furthermore, the data which is kept and where it is kept may vary from rev 
to rev. In order to fadlitotc analysis of crash dumps, a program called AUTOPSY has been 
written. This program allows the dump to be examined in a logical manner, providing 
information about the state of the system in terms of users, semaphores, file s3rBtem, etc. in a 
format which is iisef ul to humans. 

1.1 Layout of this document 

The description of AUTOPSY proceeds in a top-down manner, describing first the procedure 
for initializing AUTOPSY, continuing with commands which are useful for any dump, and 
then describing more complex commands which may apply only to certain classes of crash 
dumps. Finally a detailed commands reference is provided. 

1.2 What this document does not do 

It is not the purpose of this document to describe the crash dump procedure; for information 
on this procedure, consult the PRIME En^neerUig Handbook (PE-T-500, Rev. l). This 
document also assumes at least a passing familiarity with the 50-series hardware and VPSD, 
the symbolic debugger. For information on the hardware, refer to PE-T-500 or the 50 Series 
Technical Summary (PE-T-1022>, for VPSD, see The Assembly Language Programmer's Guide 
(FDR 3059). 

2 Initializing AUTOPSY 

When a crash dump is to be analyzed, it may be on either of two storage media: magnetic 
tape or disk. The procedure for initializing AUTOPSY in each case is described in this 
section. (Usually, AUTOPSY may be found either in CMDNCX) as the external command 
XAUTOPSY, or in the directory which contains the crash dumps as AUTOPSY.SAVR) 

2.1 Reading a crash dump from tape 

In order to read a crash dump from tape, first assign the tape drive on which the tape is 
mounted, and then invoke AUTOPSY. AUTOPSY wiU respond with its version number and a 
prompt, for example: 

[Autopsy 19.6.14] 
> 
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(AUTOPSY will always prompt with ">" when it is ready for the next command.) To read 
the dump in from tape, use the READ command, for example: 

Rtod snb. 63/68. 1233 1 



"enb.03/08.1233'' is the name that the crash dump file will have on disk. "1" is the 
magnetic tape drive number which has previously been assigned. (If the tape drive is not 
assigned, AUTOPSY will abort with an "MTx not assigned" error. In this case, assign the 
drive at that point, and restart AUTOPSY with the START command.) Note that since most 
crash dumps are at least 512 records long (they may currently be up to 4K records long), the 
directory into which the dump is read should have plenty of storage available. 

When the dump has been read in, AUTOPSY wUl display the status of the Read command, 
along with information about the dump, as: 

Dona I 

2648 Pages in fll«, 2649 Taps rscords, 1 wsrs duplicated. 



If any tape errors occurred, they will be described here. 

AUTOPSY next gives you general information about the crash that has just been read in. 
This information is described in the next section on reading dumps from disk. 



2.2 Reading a dump which it already on disk 

In order to read an existing crash dump, AUTOPSY may be invoked with a treename on its 
command Une: 

X. AUTOPSY <trseno«e> 



<treename> is the name of the file containing the existing crash dump. If you have already 
invoked AUTOPSY (or have finished examining one dump and wish to examine another), use 
the FROM command: 

From snb. 63/68. 1233 
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When AUTOPSY has finished reading in the dump, it prints the following information 
(known as the "date header*'>. 

Revision of PRIMOS Tima PRIMOS wo> built Tim* of croth 

MAP6EN Rovialon 

Vorsion: 19.6.86 e2/25/82**13:ei :e2**17.1 82-03-08. 12:33:e8.Mon 

Crash: ENB. 83/08. 1233 

CPU: P750, mlcroeods rsv. 15 

Dump fils noffls 

Procsssor typs Rsvtston of ailcrocods in processor 

23 Seading maps 

Many of the more advanced features of AUTOPSY can be supported only if the maps 
describing PRIMOS are read by AUTOPSY. In order to read the maps (there are currently 
two: one for ring zero, and one for ring three), use the MAP command: 

MAP [<trs«naiii«_1> [<tr«enaffls_2>]] 

If no names are given to the MAP command, it looks in the top-level directory called MAPS 
for files with the name 

RING(0 3).lylAP.<v«rslon> 

Where <vcrsion> is the PRIMOS revision number printed in the date header. An example 
with no names given follows: 

> MAP 

Rsoding ring nop for vsrslon "19.0.86". 
Donsl 1444 ontrlss in symbol table: 

761 routines. 247 common blocks, 436 other symbols. 



Reading ring 3 nop for version "19.0.86". 
Donel 2010 entries In symbol table: 

1076 routines, 257 common blocks, 677 other symbols. 



The symbol table now contains maps describing PRIMOS revision 19.0.86, which contains 1076 
procedures, 257 common blocks, and 677 other symbols. Making further use of the 
information contained in the symbol table will be described later. 
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3 Examiniiig the dump 

Now that the dump has been read in, we must look at it to determine what went wrong. 
The first thing to do is to find out what user was miming when the system crashed. 

3.1 The RPRNT command 

Detennining the user running at the time of the crash is done with the RPRNT (register 
print) command and the LIVE (live user) c^on. The output from the RPRNT command 
might look like this: 

> RP LIVE 

Uatr I 44 Timer > -113 

PB: 12(e)/74426 SB: 6ee3(e)/162 LB: 12(e)/7413e XB: 27(e)/55421 

FRe e64eee.ee2Si6.eeeeee.eeeeeo e. 2387724758470383350-98 

FR1 eeeee2. 140714. 142736. 145640 0.152394881579928236-407 





(OCT) 


(DEC) 


A 


000002 


2 


B 


vOOvvV 





L 


000002.000000 


131072 


E 


075170.066247 


2054712487 


X 


vOvOvQ 





Y 


QOOOOO 






KEYSAIODALS 01 4000 . 1 001 77 

FCOOE/FAOOR 104000.000064 4000(3)/4226 

DTARft-3 127700.012000 140000.012501 140006.033100 176406.033064 



From this we can tell that user 44 (octal; all numbers in AUTOPSY are assumed to be octal) 
was nmning in segment 12 at the time of the crash. More generally useful information can 
be gotten with the STATUS command. 

3.2 The STATUS command 

The STATUS command prints information about one or more processes, including user or 
process ID, base registers, last wait location, and wait state. The results of a "ST 44" 
command would be: 

> STAT 44 

Uttr I 44 ALEXK PB: 12(0)/74426 SB: 6003(e)/162 LB: 12(0)/74130 

XB: 27(0)/55421 
LEVEL : 626 PRIORITY 1 USER •READY* WAS WAITING AT: 0/546 

•LIVE* •MASTER^ 
LOKOWN: NETLCK 
ABSAVE: NONE 
PCBABT: NONE 
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3 J The LOCSEARCH command 

We can find out the name of the module in which the user was executing by using the 
LOCSEARCH command* 

LO 12/74426 

12/74426 ot LB XLCCON + 276 

Routine none: XLGCON 

ECB: 12/75146 P8: 12/74726 LB: 12/74536 

Now >ist from two commands (RP and LO) weVe discovered something very interesting: user 
44 seems to have been executing part of his linkage area! 

3^ The CHKPRT command 

The fact that the user was running in his linkage area makes us wonder what strange things 
may have been happening to the machine, so we next see if there have been any machine 
checks with the CHKPRT command: 

> CH 
Lost check handled: 

DSWPB: 12{e)/1B2124 

OSWRMA: 6ee3(e}/652 

DSWSTAT : 627 1 76 . 1 74000 
OSWPARITY: 607101,603504 

Memory parity error on oap, phyelcal page 7636 (corrected) 

SSU parity error 

RMA not Incremented at error 

BMA15 at error 

6MA16 ot error 

ECCC on Cache Miss 

Coche cycle for execution 

Check headers: 

Memory parity at 12(e)/ie2124, Keys - 614600. Models - 160177 

Ahal There has been a machine check. On the other hand, it looks like a harmless ECCC 
(corrected memory parity) error. However, the error did occur in segment 12, where we were 
executing, so we again use the LOCSEARCH command to find out exactly where the problem 
occurred: 

> LO 12/162124 

Routine name: X$FLDM 

ECB at 12/162236. PB-12/162124, LB-12/iei626 
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We have just discovered that the ECXX error occurred on the first instruction of a routine 
called XSFLDM. It just so happens that we've found the cause of the problem, because we 
know from experience that PTSCs with microcode prior to rev 23 have a microcode bug that 
drives them batty if they take an ECXX: during an ARGT instruction! Just to be on the safe 
side, however, we want to take a look at the instruction at 12/102124 to make sure it is an 
ARGT. We do this with the RESTORE command; 

3.S The RESTORE command 

> RESTORE 12 

$ a 102124 /• In VPSD; ottach to offending location 

4eei/ 102124 ARGT ? /• Wo do hovo on ARGT; rolooto location 
$ q /• Roturn to AUTOPSY 

> 



We have now solved this crash dump. Not all crashes will be this easy to solve, but even 
this relatively easy crash woiad have been difficult without commands like RPRNT and 
C3DCPRT. 

4 More advanced commajids 

The commands discussed in the first section are useful for almost all dumps. This section 
describes some of the more advanced commands available in AUTOPSY for analyzing more 
complex dumps. 

4.1 The TRACE command 

The TRACE command enters a subsystem of AUTOPSY which allows you to examine, in 
detail, the stack for any user on the system. TRACE lets you retrace the steps that a process 
took to get where it was when the system halted. At each level of the stack, TRACE 
displays information such as the PB, LB, and SB rf the process; the size of the stack frame; 
and, if maps are available, the names of both the called and calling routines. Subcommands 
to TRACE allow you to travel freely up and down the stack or to any particular frame on 
it, as well as to examine all or part of any of the frames. TRACE is invoked by. 

Troco <us«r> [<oddros«>] 

If <address> is given, the trace begins at <address>, which must be the base address of a 
legitimate stack frame. Otherwise, the trace begins at the current SB of the <user>. Once 
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•within TRACE, you can use the basic commands Father to go back down the stack, and Son 
to go up. For instance: 

> TRACE 176 



L*v«l 1: PREVSB. 

Root: sees SB: 6ee3/1652 Six*: 57 words Typo: eeeeee (PCL) 

Koyo: •34eee 

Coll ot 6(e)/14267e (QUTABT-l-52e) SB: 6ee3(e)/U72 LB: 6(e)/U2662 

(troco)> FATHER /• Noto dlfforont proapt 

Lovol 2: QUTABT 

Root: 6ee3 SB: 6003/1472 SIzo: 111 words Typs: eeeOOO (PCL) 

Ksys: 614000 

Coll at 6(e}/54227 (LOGABT-t-261) SB: eee3(e)/1414 LB: 6(e)/537ie 

(troco)> F 

Lsvsl 3: LOGABT 

Root: 6003 SB: 6003/1414 SIzs: 45 words Typs: 600000 (PCL) 

Ksys: 614000 

Coll ot 6(0)/34547 (PABORT+405) SB: 6eO3(0)/1364 LB: 6(6)/34266 

(trocs)> F 

Lsvsl 4: PABORT 

Root: 6003 SB: 6003/1364 Sizs: 23 words Typs: 600000 (PCL) 
Ksys: 014000 

Coll at 6(0)/4371 (PRCFP (st al)+177756) SB: 60O3(0)/1274 

LB: 6(6)/5130 

(tracs)> SON /• Go back a lsvsl 

Lsvsl 3: LOGABT 

Root: 6003 SB: 6003/1414 Sizs: 45 words Typs: 600000 (PCL) 

Ksys: 614000 

Call at 6(0)/34547 (PABORT-f405) SB: 6e03(e)/1364 LB: 6(0)/34266 

(trocs)> F 6 /• Trocs through six fathsrs 

Lsvsl 9: INIT$U 

Root: 6003 SB: 6003/604 Sizs: 133 words Typs: 000000 (PCL) 
Ksys: 614200 

Coll at 15(0)/11011 (PHLOGIN (st al)-t-515) SB: 60O3(O)/162 

LB: 15(6)/10564 

(tracs)> Q /• Dons 



In addition to the basic Father and Son commands, TRACE allows you to: examine the stack 
at the current level (STAC3C command), display arguments to the current procedure 
CARGUMENTS command), or GOTO a specific level of the stack, among others. Full detaUs 
are in the commands reference section. 
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4.2 The TTYBUF command 

The TTYBUF command allows you to read the tenninal input and/or output buffers for each 
tenninal ii3er on the «ystem, as well as for special processes which have their own buffers. 
Reading user I's terminal buffers can prove especially enlightening since disk errors and such 
are displayed there. The syntax of the TnfBUF command is: 

TTybuf <ua«r> [-<buff«r>] [-CRLF] [-OCTAL] 

If no <buffer> option is given, the user's input and output buffers are printed. Otherwise, 
only the specified buffers are displayed. (A complete list of the available buffers is given in 
the commands reference section. The most useful are -INPut, to display only the user's input 
buffen -OUTput, to display only the user's output buffer, and -User_l_31essage, to display 
user I's message buffer.) If the -CRLF option is given, lines are displayed with newline 
characters as they would have appeared at the terminal; if the option is not supplied, the 
format is as for an ASCH dump in VPSD, except that there are no spaces between the 
contents of each word. If the -OCTAL option is given, control characters are shown as three- 
digit octal numbers preceded by an uparrow (*). The buffers are displayed in chronological 
order, with the most recent input or output at the bottom of the display, for instance: 

> TT 1 

Input buffer (4ee byt*« long) for uaor 1 at 7(e)/ieie64: 

I. ".#.$. .A CMDNCe.X.MAIL SKIP MM.M SKIP NOW -ON END. Mall 

I« back MAX e.SE -630882 -1236. DATE. ROY. .C. .C.X. MAIL SKIP 

»•<. DELETE MM -«PT.M SKIP NOW -ON END. HOW ABOUT NGW MAX ALL.PH 

UI.B>PHJBOOT.RDY.M ALL NOW. LOGIN PLEASE ????????????DATE. 

Output buffor (600 byto* long) for usor 1 at 7(6)/d: 

d«lot«d...OK. OK, OK, PHANTOM la uaor 166. .OK. OK 12:32:03 7.63 
6 6.163 laval 2-t-. .OK. ...••• SYSTEM (uaor 166 on EN8) at 12:32 

EVERY THING IS O.K LINE MONITOR STARTED. .. .OK. ..Ph 

onton 106: Normal logout at 12:32.. Time uaad: 00h 99n connect. 6 

0ni e2a CPU, 00n e2a I/O •• BATCH_SERVICE (uaor 101 on ENB) 

at 12:32... Monitor eonttnuad. . . .08 Mor 82 12:32:56 Monday.. OK. 

> TT -USER_1_MESSAGE -CRLF 

Uaar 1 naaaoga buffar (606 bytaa long) at 7(6)/132667: 
AN r»v 1.6] atartad. 

••• SYSTEM (uaar 162 on ENB) at 12:31 

•••ERROR IN START PHANTOM*^^ PHANTOM NOT STARTED.. 

••• FTP (uaar 165 on ENB) at 12:31 

12.31.19: FTS Sarvar - FTP atartad up on Monday. March 8. 1982 

••• SYSTEM (uaar 166 on ENB) at 12:32 

•••EVERY THING IS O.K LINE MONITOR STARTED. 

••• BATCH_SERVICE (uaar 101 on ENB) at 12:32 
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Monitor continued. 



43 The UIBL and UTENTRY commancU 

The UTBL command enables you to examine the contents of a unit table for any user on the 
system. A unit table contains a list of offsets into the unit table entry common. Each 
offset defines the location of a unit table entry, and each unit toble entry describes a unit 
that the user holds open. The UTliNl'RY command allows you to display the contents of 
individual unit table entries. The format of the commands is: 

UTbl <ut«r> 
UTEntry <us«r> <unlt> 



Examples of both commands follow; 



> UTBL 1 

Unit tobi* for user 1 (ot ie(e)/ie71): 

Syatem unit ot 1 

Unit 175 at 551 

Attach polnta: current at 25, home ot 51, initioi at 75 

> UTE 1 175 

Entry for unit 175 (at 4e(e)/167e [551]): 

Statue: 116882 (Type: SAIy| f I le Mode: « modified no ciose) 

RWIock: 5 (none) 

Aeceeses: 2 (W) 

Ldev: 6 

BIM: 32146 CRA: 32146 

Position: word 234 in relative record 

Entry at: word 533 in directory with BRA 4622 

DIr blocic ot: 41 

Hash thread: 8 



4.4 Commands to check system consistency 

Two commands, each ending in "CHK," cause AUTOPSY to automaticaUy check certain 
PRIMOS databases for consistency. The FSCHK command checks the file system hash tables 
for circular or orphaned threads, while the PAGrCHK command checks the memory maps 
(MMAP, HMAP, and LMAP). Messages will be printed if any problems are found. 
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5 Command Reference 

This section provides a detailed commands reference guide for AUTOPSY. We hope to keep it 
up-to-date by providing addenda as new commands are added. 

The minim u m abbreviation for a command is shown in uppercase in the command name. All 
commands are left-substring abbreviatable. Only the first four characters are checked. 

S.l CHKPRT — Print description of last machine check 
CHkprt 

The CHKPRT command prints a detailed human-readable description of the last machine check 
which ocairred, plus the check headers of any other checks. An example of the output for a 
recovered memory parity error (EOOC) follows: 

> ch 

Loit check handled: 

DSWPB: 12(e}/ie2124 

DSWRMA: 6ee3(e}/652 

DSWSTAT : 027 1 70 . 1 7*000 
DSWPARITY: 007101.003504 

Memory parity error on oap. phycicol page 7636 (corrected) 

SSU porlty error 

RMA not incremented at error 

BMA15 at error 

BMA16 at error 

CCCC en Cache Miee 

Cache cycle for execution 

Check headera: 

Memory parity at 12(0}/102124, Keye « 014000. Modala - 100177 

Other information may be displayed according to the nature of the check and the machine on 
which it occurred. For instance, the 850 communications area status word is displayed for 
checks occurring on PSSO's. 

SJt CLRMAP — Clear symbol table 

Qrmap 

The CLRMAP command clears the symbol table databases so that new maps may be read in. 
Note that once even one map has been read in, the MAP command may not be given without 
a treename unless CLRMAP is given first 
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53 CX)MSEARCH — Search cymbol table for common block 

OOmsearch <address> 
The COMSEARCa command searches the symbol table for a common block at the specified 
address (wordnumber/aegmentnumber). If one is found, its name and address are displayed. 

5A DDQB — Dump Disk Queue Blocks 

DDqb [<start> [<end>I] [-FREE] [-USED] [-MeTeRs] 
Dumps the disk queue control blocks. If no options are specified, all blocks are displayed. 
Otherwise, the arguments and options act as follows: 

o <atart> only: Dump* QCB number <atart> (first is zero). 

o <atart> <«nd>: Dumps QCBs <start> to <snd>, incJusivs. 

o -FREE: Displays blocks currsntly not in use. 

o -USED: Displays blocks currently In use. 

o -METERS: Displays DISKIO meters in Addition to QCBs. 



5.5 DLCB — Dump Locate Control Blocks 

DLcb [<start> [<end>Il [-FREE] [-Hash_Table] 
Dumps LOCATE control blocks. If no options are specified, all blocks are displayed. 
Otherwise, the arguments and options act as follows: 

o <start> only: Dumps LCB number <start> (first Is zero), 
o <start> <end>: Dumps LCBs <start> to <end>. Inclusive, 
o -LRU.LIST: Displays blocks in most-rscently to 

least-recent ly used order, 
o -HASH.TABLE: Displays LOCATE hash toble. 



5.6 DSEMAPHORE — Dump Semaphore 

DSemaphore <aiddress> [<user>] 
Dumps the semaphore at the specified location. If <user> is omitted, the current tiser is used. 

/■ 

5.7 DUMP — Dump memory contents 

Dump <address> <last_word> [<U8er>] 

<address> is the starting address of the area to be displayed. <last_word> is the last word 
number to be displayed. (DUMP may not cross segment boimdaries.) If the segment to be 
dumped belongs to a user other than the current user, <user> specifies to which user it 
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belongs. The area is iJways dumped in octal, 8 words per line. 

5.8 DATE — Display date header 

DAte 
The DATE command displays the date header which is printed when a file is read with the 
FROM command. The names of any maps are also printed. 

5.9 ECBSEARCH — Search symbol table for an ECB 

Ecbsearch <address> 

The symbol table is scanned for an ECB at or near the given address, and if one is found its 
name and location are displayed. 

5.10 FROM — Load a dump from a file 

From <treename> 

Reads the dump in file <treename> into memory and initializes the AUTOPSY databases. 
When the dump has been read in, displa3rs the date header, which gives information on the 
revision of PRIMOS running at the time of the crash, when that system was loaded, and 
when the crash occurred. 

5.11 FSCHK - Check File System hash tables 

FSchk 

Checks the file system hash tables for consistency. Prints messages describing the nature of 
the problem and where it occurs if circular or orphaned hash threads are found. 

5.12 HELP 

Help [<topio] 

If a <topio is specified and it exists in the HELP database, detailed information on the topic 
is displayed at the terminaL Legal topics are all commands plus "NEW," which describes 
recent changes to AUTOPSY. If no <topio is given, a brief description of all commands is 
given. 
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5.13 Keyprt — Decode keys and modals 

Keyprt <keyB> <modals> 
Displays the decoded versions of the specified key and modal values. An example follows: 

> k«yp 14201 100176 



Brcokdown of Keys 614201: 




Procaaaor node: 


64V 


C>bit: 


off 


0-blt: 


off 


L-bit: 


off 


Floating exceptions: 


ol lowed 


Integer exceptions: 


allowed 


Condition cedes: 


LT/NE 


In dispatcher bit: 


off 


Save done bit: 


on 


Breokdown of Modal s 100176: 




Interrupts: 


enabled 


Vectored interrupt bit: 


off 


Mapped I/O: 


enabled 


Process exchange: 


enabled 


Segmented node: 


enabled 


Current register f i le: 


3 


Machine check node: 


All but ECCC checks 



5.14 LBSEARCH - Search symbol table for module with given LB 

LBseaich <address> 

Searches the sjmibol table for a module with the specified LB, and returns its name, ECB 
address, PB and LB if one is found. 

5.15 LBNames — Search symbol table for modules with given LB 

LBNames <address> 
Searches the symbol table for all modules with the specified LB, and returns their names. 

5.16 LOCSEARCH - Search symbol table 

LOcsearch <address> 
Searches the symbol table for the symbol nearest to the specified address, and returns data 
appropriate to the type of symbol which is found, including the offset of the <address> from 
the symbol 
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5.17 LPRNT - Display NILOCK itatus 

Lpmt 
The LPRNT command displays the status of all the PRIMOS NlLOCKs. For each lock, the 
nximber of leadeis and writers waiting is displayed. 

5.18 MAP - Read mapCs) 

Map [<treename_l> [<treename_2>]] 
The MAP command reads the PRIMC^ memory maps generated by SEG at load time into an 
internal symbol table which is then used by may of AUTOPSVs commands. If no treename 
is specified, AUTOPSY attempts to read both ring zero and ring three maps from files with 
the names RINCKO 3)MAP.<version> in a top-level directory caUed MAPS. Only two maps 
may be \xsed by AUTOPSY at one time; in order to read in new maps, you must first use 
the (XRMAP command to reinitialize the symbol table. 

5.19 OTHSEARCH - Search symbol table for Other symbol 

Othsearch <address> 
Searches the symbol table for the "other" symbol (that is, neither a procedure nor a common 
block) nearest the specified address. Returns its name and address if found. 

5.20 PAGCHK — Check page maps for consistency 

PAgchk 
The PAGCHK command checks the page maps (MMAP, HMAP, and LMAP) for consistency. 
Any anomalous entries are listed. 

5.21 PAUSE - Suspend AUTOPSY session 

PAUse 
Suspends ttus session of AUTOPSY in a restartable state. 

5.22 PBSEARCH - Search symbol Uble for module with given PB 

PBsearch <addre8s> 

Searches the symbol table for the module with the PB closest to the specified address. If one 
is found within 1000 words, its ECB address, PB, and LB are displayed. 
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5^ PDUMP - Display PCB for ipecified user 

Pdump [<user>] 

EWspkys the PCB (including concealed stack) for the given user (or the current user if 
omitted).. The display is in octal, 8 word per line. 

5^ PMAP — Display page maps for given legment 

PMap <atgmtnt> [<user>] 
Displays the LMAP and HMAP entries for the segment specified. The page maps are 
displayed in octal, 8 words per line. If <user> is omitted, the current user is assumed. 

5.25 QUIT - Exit AUTOPSY 

Quit 
Exits autopsy. 

5.26 RDUMP — Display register save area 

RDump [{SLAVE I AP}] 
Displays the register save (RSAV) area. On P750's and below, there is only one RSAV area, 
and that is displayed. On P850's, the master processor's RSAV area is displayed by default. 
The SLAVE option dumps the slave processor's registers, while the AP option dumps the 850 
commimications area registers. 

5.27 READ — Read a dump from tape 

Read <treename> <mt^unit> 
Reads a crash dump into file <treename> from magnetic tape drive <mt_unit>. The drive 
must have been previously assigned, or AUTOPSY will abort with a "MTx not assigned" error. 
After the dump has been read in, statistics on its size and the number of errors encountered 
are displayed. 

5.28 RESTORE - Load a segment for VPSD 

REStore •<segment> [<user>] 
Loads the specified segment into segment 4001, which is VPSI^s default segment number, and 
then invokes the VPSD subsystem. If <uscr> is omitted, the current user is assumed. Note 
that if the <Begment> is less than 4000, the current user is set to 1. 
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5.29 RPRNT - Print live registers 

RPmt [{LIVE I LAST}] [SLAVE] 
Displays the live register seta for the LIVE or LAST user using the processor. On a P850 
this command appUes by default to the master processon the slave processor's UVE and LAST 
process' registers are examined by adding the SLAVE argument If neither UVE nor LAST is 
supplied, LIVE is assumed. 

S30 STATUS — Display status information 

Status {<uaer> I ALL 1 USERS} 
Displays basic status for the specified <user>, ALL processes on the system, or all processes 
associated with USERS (as opposed to system processes; that is, those with positive user 
numbers). This status includes user or process ID. current base registers, last wait location, 
locks held, and whether the process was running and/or on the ready list. 

5J1 SYMBOL - Display location information for given symbols 

SYmbol '«ymboll> <symbol2> _. 
Displays the type (routine, common, or other) and address information for the specified list of 
symbols. For common blocks and other symbols, the address is displayed. For routines, the 
PB, LB, and ECB addresses are listed. 

5 J2 TRACE - Enter the TRACE subsystem 

Trace <user> [<address>] 
The TRACE command enters the TRACE subsystem for the specified <user>. If an <address> 
is given, the trace begins at the stack <address> specified. The TRACE command traces back 
down the user's current stack much as DMSTK docs at PRIMOS command level, except that 
with the TRACE subcommands you have much more control over the examination of the 
suck. 

At each level of the stack trace. If maps have been read in, the name of the routine and the 
offset of the PCL in the calling routine are displayed at each leveL If more than one 
routine has the LB of this level, -Xet al)" i^ displayed after the name of the first routine 
with this LB. TRACE will automatically resolve the routine name when the next level if 
pushed, if possible, and will remember the name during any future passes through this level 
which are made during the current invocation of TRACE. If TRACE cannot resolve the 
name itself, commands are available which allow you to tell TRACE which name it should 
use. 
Experienced users of AUTOPSY should note that the TRACE subsystem was completely 
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rewritten at version 19.0.13. The new format is documented here, with references to the old 
conunands (which wiU continue to work at least for a whHe). It is particularly important 
to note that TRACE no longer operates in character-by-character mode; carriage returns are 
now required after commands. 

Commanids to the TRACE subsystem are: 

Arguments 

Olspioya argumcnta ot thit l«v«l. 

Current [formerly '.') 

Rcditploy* the current frame. 

Father [<n>] (formerly -") 

Traces back to the next etaek level. If <n> la given, 
troeet bock <n> J eve I a or to the end of the atack. 

Goto l<level>] 

Mokea <tevel> the current level. If omitted. <level> de- 
foulta to 1. 

Help 

Prlnta Hat of commanda ond brief deacrlption of each. 

Ust^Procs 

Oiaplaya all procedurea which have the LB of the current 
frome'a colling routine. Thia command la uaefut If the 
eoller'a name diaplayed by TRACE la followed by "(et al)". 
which Indlcotea that multiple entry polnta uae thie LB, ond 
that TRACE could not diatingulah between them. 

QuU (formerly T) 
EKite TRACE. 

Restart [<address>] 

Reatarta the trace at the apacif led <addreaa>. If <oddreaa> 
ia omitted, mokea the current frome the baae frame for future 
tracing. ThIa command la uaeful for atocka which hove more 
levela (257) than TRACE con currently handle. 

Set_Proc <routine_name> 

Allowa you to tell TRACE which routine you want It to conalder 
the one which actually mode the coll. Moy be uaed only when 
the calling routine hoe multiple entry polnte. Note that when 
you get to the next frame TRACE will automatically reaolve the 
conflict if poaaible: therefore, it moy be o good Idea to go 
to the next level before uaing thia command. 

Son [<n>] (formerly <cr>) 

Goea back to previoualy traced level, or <n> levela If ao 
specif led. 

STack [<start> [<end>J] (formerly 'M') 

Dumpa the current frame in octol. If specified, only relo- 
tlve locotiona <atart> to <end> ore dumped. <atart> defoulta 
to 'ie. ond <end> to the end of the frame. 

User <user_jmmber> [<address>] 

Starta trocing a different uaer at the apecified <addraa8>. 
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5JJ3 TTYBUF - Display terminal buffers for given user 

TTybuf <uMr> [-INput] (-OUTput] t-U««r_1_M«««09«l 

[-CEWtronlcO] [-CENtronietJZ] [-CARD_r»o<l«r] 
[-Pop* r_Top«_R«ad« r] [-Pop* r_Top«_Punch] 
[-OCTal] t-CRLF] 

If the -CRLF option is not supplied, the format is as for an ASOI dump in VPSD, except 
that there are no spaces between the contents of each word. Otherwise, carriage returns are 
output literally. If the -OCTAL option is given, non-printing characters are displayed as 
three-digit octal numbers preceded by an uparrow C^"). Buffers are displayed in chronological 
order, with the most recent input or output at the bottom of the display. 
If none of the buffernKlection options are given, the user's input and output buffers are 
dispUyed. Otherwise, the buffers displayed are selected by the options specified as follows: 

INPUT: Sp«elfi«d u«*r'« terminal Input buff«r. 

OUTPUT: Specified user's terminal output buffer. 

U1M: User 1 message buffer. 

CEN1: First Centronics printer's buffer. 

CEN2: Second Centronics printer's buffer. 

CARD: Cord reader buffer. 

PTR: Poper tope reader buffer. 

PTP: Poper tape punch buffer. 



534 UNIT — Display contents of specified unit table entry 

Unit {<offset> I <address>} [-uNFormatted] 
Displays the contents of the unit table entry which resides at the given UTCOMS offset or 
absolute address. Format is as for UTENTRY, below. 

5 J5 UOWNER - Display owner of specified unit table entry 

UOwner {<offset> I <address>} [-DISP] 
Returns the owner (user and unit number) of the unit table entry which resides at the given 
UTOOMS offset or absolute address. If the -DISP option is given, the contents of the unit 
table entry are dumped as for the UTENTRY command, below. 

536 UTBL - Display unit tale of specified user 

UTbl <user> [-uNFormatted] 
Dumps the contents of the specified user's unit Uble. Normally this information is given 
only for existing units in the form "Unit <unit> at <offset>.'' where <unit> is the unit 
number and <offset> is the word offset into the unit table common area at which the unit 
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toble entry may be found. For pre-rev 19 dumps, or if the -UNFORMATTED option is given, 
the unit table is dumped in octal, 8 entries per line. 

SJ7 UTENTRY — Display specified unit table entry 

UTEntry <user> {<umt> I -CURient i -HOME I -INTTial} 

[-uNFormatted] 

Displays the unit table entry for <user>'8 <UDit>, or one of the specified attach points, in 
decoded form. For pre-rev 19 dumps, or if the -UNFORMATTED option is given, the entry is 
displayed in octal, 8 words per line. 

There are three forms the formatted version of the dump may take, depending on whether 
the unit is a file unit, attach point unit, or remote unit. An example of each foUows: 

> ut« 1 175 

Entry for unit 175 (at 4e(e)/1454 [335]): 



Stotus: 


1 (Typs: SAM fits Mode: r) 


RWIoek: 


1 (oxcl) 


Ace«aa«t: 


377 (PDALUXWR) 


Ldev: 


e 


BRA: 


15727 CRA: 15727 


Position: 


word 9 in rslotive record 


Entry at: 


word 3540 in directory with BRA 14 


Dir block 


at: 11 


Hosh throod: 6 


> ut« 44 -cur 


Entry for 


unit 200 (at 4e(e)/2654 [1535]): 


Status: 


2404 (Type: ACL dir Mode: op) 


Accssses: 


31 (LUR) 


Ldsv: 


e 


BRA: 


160346 CRA: 160346 


Pos i t i on : 


word 200 In relotive record 


Entry at: 


word 6404 in directory with BRA 1 


ACL at: 


word 3022 in directory with BRA 1 


Quota block at: 201 


Dir block 


at: 211 


Hash thread: 2665 


> ut« 44 


170 



Entry for unit 170 (at 4e(e)/3520 [2401]): 
Status: 3 (Type: SAM file Mode: rw) 
Node: 1610 
Unit in slave: 175 
Ldev: 37 
Pock name: SYSENH 
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538 VPSD - Invoke VPSD «ul»y»tein 

Vpsd 
Invokes the VPSD lubsystem. NonnaUy this is done with the RESTORE command, above, 
since that command automatically lestoies (me of the dump's segments into segment 4001, 
which is VPSiys default segment. If Uve memory or AUTOPSY'S memory is to be accessed, 
the VPSD command may be used inrtcad. Note, however, that if the segment number being 
examined is changed from 4001, subsequent calls to VPSD, even with the RESTORE command, 
will reference the new segment rather than the restored segment mapped into 4001. 

VPSD is described fully in The AssemUy Language Programmer's Guide (FDR 3059). 

539 t — Execute PRIMOS command 

! <primo8__command> 
Executes the specified PRIMOS command, which must be internal or an EPR Using the I 
command to invoke a static mode external command may cause AUTOPSY to abort, or at 
least corrupt its database. 
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